home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / Resources / CDROM / FlashROM / FlashROM.doc < prev    next >
Text File  |  1999-09-02  |  16KB  |  440 lines
  1. FlashROM V1.2, 02.09.99
  2. =======================
  3.  
  4. Introduction
  5. ------------
  6. FlashROM is a tool to update the flash ROM of a SCSI or
  7. ATAPI drive. At the moment it supports Plextor and Yamaha
  8. CD writers. A complete list is given below, together with
  9. remarks about supporting other hardware. Any SCSI or ATAPI
  10. device can be used as long as it is compliant to the Amiga
  11. SCSI direct standard.
  12.  
  13.  
  14. Disclaimer
  15. ----------
  16. Neither the author of this tool nor the vendor of the drive
  17. shall be held responsible for any damages or losses, direct
  18. or consequential, resulting from the use, or inability to
  19. use the software. This applies even if the authors have been
  20. made aware of the possibility of losses or damage.
  21.  
  22. FlashROM is copyright 1998-99 by Patrick Ohly. Copying and
  23. usage are allowed for free as long as no profit is made in
  24. doing so. Commercial distribution or distribution together
  25. with commercial products or commercial usage of FlashROM
  26. require the permission of the author.
  27.  
  28.  
  29. MakeCD + Availability of FlashROM
  30. ---------------------------------
  31. FlashROM was brought to you by the author who also wrote the
  32. SCSI, IO and GUI part of MakeCD, an "excellent" (Amiga Format
  33. #112) CD writing software for the Amiga. In contrast to one
  34. of our competitors I have decided not to restrict the usage
  35. of this tool to the users of our CD writing software.
  36.  
  37. MakeCD does not need such an exclusive feature to be worth
  38. its money and I don't want anybody to buy it just to update his
  39. or her drive. Of course you are welcome to have a look at
  40. MakeCD in case that you should not know or use it already. An
  41. only slightly restricted demo of the current version is
  42. available at "http://makecd.core.de/". You will also find the
  43. current version of FlashROM there.
  44.  
  45. I also believe that updating the firmware of drives is not one
  46. of the tasks a CD writing software should take care of. I regret
  47. that our competitor was not able to make their tool available
  48. to the Amiga community for free because of costs they had and
  49. still would have and because of their liability in case of a
  50. damage. I understand their objections and even though I decided
  51. to go a different way I share them, so once again in plain
  52. English: FLASHROM COMES WITH ABSOLUTELY NO WARRANTY OR SUPPORT!
  53.  
  54.  
  55. Usage
  56. -----
  57. FlashROM has no graphical user interface. It is started from
  58. a Shell and takes the following arguments:
  59.  
  60.    DEVICE,ROMFILE,UNIT,DRIVE/K,OPTIONS/K
  61.  
  62.    DEVICE  - SCSI or ATAPI device name, e.g. scsi.device;
  63.              if no device name is given FlashROM prints a list of
  64.              the currently available Amiga Exec devices.
  65.    ROMFILE - file containing the new contents of the ROM;
  66.              the file has to be uncompressed. If it is not named
  67.              FlashROM will only try to find a known drive or
  68.              check the given unit.
  69.    UNIT    - unit number of the drive to be flashed;
  70.              if no unit is specified FlashROM scans the SCSI bus
  71.              for a drive it knows, so usually this argument doesn't
  72.              have to specified.
  73.  
  74. The other arguments are usually not required:
  75.  
  76.    DRIVE   - FlashROM has a builtin list of known drives and chooses
  77.              the update method based on the drive's vendor and product
  78.              code (e.g. "PLEXTOR CD-R   PX-R412C").
  79.              If your drive is not recognized but compatible with one
  80.              of the known drives listed below, you can override the
  81.              drives ID with DRIVE "<known drive>". Don't forget the
  82.              quotes and choose the drive ID carefully. Spaces in the
  83.              product code are relevant.
  84.    OPTIONS - Some of the update methods may require additional
  85.              arguments for drives that are new and not just clones of
  86.              the known drives. See the description of known drives
  87.              below.
  88.  
  89.  
  90. Step by step instructions
  91. -------------------------
  92. 1. Get the firmware that you want to upgrade to. See below
  93.    for addresses.
  94.  
  95. 2. Plextor PX-R412C only:
  96.    Set the flash switch on the drive as documented in the
  97.    manual for your drive while the drive and the computer
  98.    are turned off. It may be either a DIP switch or a jumper
  99.    header, so consult the drive's manual for further info.
  100.  
  101.    CAUTION: Don't insert the Caddy during Flash mode. If you
  102.    try to insert it or force it in, it will cause a malfunction!
  103.  
  104. 3. Unpack the archive. FlashROM will tell you if it can check
  105.    the ROM file before sending it to the drive. In this case
  106.    no harm will be done if you forget to unpack it or use a
  107.    wrong one, but sometimes this is not possible, so take care!
  108.  
  109. 4. Open a Shell window. If the FlashROM tool is not found by
  110.    your shell, then "CD" to the directory where it is
  111.    located or type in the complete path each time you want
  112.    to start it.
  113.  
  114. 5. Find out what the name of your SCSI or ATAPI device is.
  115.    If you start FlashROM without any arguments you will get
  116.    a list of the available devices and the correct one will
  117.    probably have "scsi" in its name:
  118.  
  119. | 4.Ram Disk:> FlashROM
  120. | Please start FlashROM with your SCSI device as argument (including
  121. | the ».device«). These devices are currently available:
  122. |    2nd.scsi.device
  123. |    clipboard.device
  124. |    console.device
  125. |    input.device
  126. |    keyboard.device
  127. |    ramdrive.device
  128. |    scsi.device
  129. |    timer.device
  130.  
  131. 6. Start FlashROM with the names of device and ROM file as
  132.    arguments. FlashROM will try to match the file with a known
  133.    drive attached to the bus:
  134.  
  135. | 4.Ram Disk:> FlashROM device 2nd.scsi.device ROMFile Plextor412_104.bin
  136. | Checking drives at 2nd.scsi.device:
  137. |   0. »cannot open«
  138. |   1. »cannot open«
  139. |   2. QUANTUM FIREBALL1080S 1Q09 - not supported
  140. |   3. PLEXTOR *Program Mode1* 1.00 - ready
  141. | 
  142. | 
  143. | Everything is ready for flashing the new contents.
  144. | The ROM file has been loaded and checked.
  145. | 
  146. | If you are not sure that your SCSI transfer is reliable and
  147. | no other system component will interfere with flashing, then
  148. | you can still safely abort now.
  149. | 
  150. | Enter »yes« to proceed. Abort with »no« or CTRL-C + RETURN: 
  151.  
  152.    If you have more than one supported drive you may have to
  153.    select the desired one by also giving the UNIT argument
  154.    on the command line explicitely.
  155.  
  156.    If the firmware check is not possible with your drive, the line
  157.    "The ROM file has been loaded and checked" will be replaced
  158.    by different texts warning you that the check was not possible
  159.    and about the consequences of using a wrong or damaged firmware.
  160.    Some drives recognize that themselves, but others have to be
  161.    reflashed to get them working again in this case.
  162.  
  163.    Plextor PX-R412C only:
  164.    If you have not set the flash switch correctly, then the
  165.    Plextor will be listed as
  166.    "PLEXTOR CD-R   PX-R412C - supported, but not ready"
  167.    and FlashROM will refuse to continue.
  168.  
  169. 7. Usually you don't have to unmount filesystems or boot
  170.    without startup sequence. You can still try it this way
  171.    if flashing the new ROM failed, but if you have known
  172.    problems with the reliability of data transfer to and
  173.    from the drive then you should solve that first. Try if
  174.    disabling reselection or synchronous transfer helps.
  175.    Consult the manual for your SCSI device to find out how
  176.    to do this.
  177.  
  178.    So far no damage could have been done to the drive and
  179.    everything is ready to do the flashing, so now enter
  180.    "yes" to proceed.
  181.  
  182.    *** Warning ***
  183.    Some controllers or systems have problems with flashing a
  184.    new firmware, probably because the drives' behaviour is
  185.    unusual while they are changing the firmware. In this case
  186.    FlashROM may hang and/or the system can be slowed down or
  187.    even crash. The ROM is still flashed properly, but be
  188.    prepared to reset the machine.
  189.  
  190. 8. FlashROM will now transfer the new ROM contents and check
  191.    it afterwards. If everything goes well you will get the
  192.    following message:
  193.  
  194. | Enter »yes« to proceed. Abort with »no« or CTRL-C + RETURN: yes
  195. |
  196. | Flashing ROM now...
  197. | done.
  198. |
  199. | The flash ROM has been changed successfully.
  200.  
  201.    Otherwise you will get an error message reporting error
  202.    codes that might help a technician to explain what went
  203.    wrong, so write them down in case you want to ask for
  204.    help.
  205.  
  206.    You will also be told if the flash ROM was damaged and
  207.    what you might do next.
  208.  
  209.    Yamaha and Plextor PX-R820:
  210.    This check is not 100% reliable. FlashROM just waits for
  211.    the drive to come up again, but cannot check if the desired
  212.    firmware is really active and correct afterwards.
  213.  
  214.    If FlashROM is not proceeding for more than two minutes, then
  215.    you will have to reset the machine.
  216.  
  217. 9. Plextor PX-R412C only:
  218.    Return the flash switch or jumper header to the former
  219.    setting according to the description in the drive's manual.
  220.  
  221. After turning on the computer again (after step 9. for a Plextor
  222. PX-R412C) or immediately (with the other drives) you can check if
  223. the new firmware ist active. It is listed after the product code:
  224.  
  225. | 4.Ram Disk:> flashrom device 2nd.scsi.device
  226. | Checking drives at 2nd.scsi.device:
  227. |   0. »cannot open«
  228. |   1. »cannot open«
  229. |   2. QUANTUM FIREBALL1080S 1Q09 - not supported
  230. |   3. PLEXTOR CD-R   PX-R412C 1.04 - supported, but flash mode not enabled
  231. |   4. QUANTUM LP240S GM240S01X 6.4 - not supported
  232. |   5. »cannot open«
  233. |   6. »cannot open«
  234. |   7. »cannot open«
  235.  
  236.  
  237. What to do in case of a failure?
  238. --------------------------------
  239. Failed ROM updates are indicated by the drives as described
  240. below and perhaps by FlashROM itself after flashing.
  241.  
  242. Try to flash again. If it still fails, check your cabling,
  243. disable reselection and synchronous transfer. Boot without
  244. startup sequence and Workbench and try it once more.
  245.  
  246. If it does not work with your computer you might ask a
  247. friend to do it with his. If you cannot access the drive at
  248. all any more, then you will have to sent it to the vendor
  249. for repair.
  250.  
  251.  
  252. Support
  253. -------
  254. This software has been made available for free under the
  255. provision that the author won't have to answer questions
  256. regarding the usage, SCSI problems, or problems with any
  257. of the supported drives. Contact the vendor of the drive
  258. for help with that.
  259.  
  260. Of course you are welcome to report bugs in FlashROM, but
  261. make sure it is FlashROM not working properly and not your
  262. system.
  263.  
  264. Plextor:
  265.   Excelsiorlaan 1
  266.   1930 Zaventem
  267.   Belgium
  268.   phone: 32-2-725 55 22
  269.     fax: 32-2-725 94 57
  270.     BBS: 32-2-720 49 57
  271.   http://www.plextor.be/
  272.   http://www.plextor.be/english/technical/download.htm
  273.  
  274. Yamaha (USA):
  275.   YAMAHA SYSTEMS TECHN0L0GY, INC.
  276.   100 Century Center Court, San Jose, CA 95112 U.S.A.
  277.   phone: 1 408 467 2300
  278.     fax: 1 408 437 8791
  279.   http://www.yamahayst.com/
  280.   http://www.yamahayst.com/techsup/download.htm
  281.  
  282. Author:
  283.   Patrick Ohly
  284.   Patrick.Ohly@gmx.de
  285.   http://home.pages.de/~Ohly/
  286.  
  287.   not longer than summer '99:
  288.   Weechstr. 1, WG E4/5
  289.   76131 Karlsruhe
  290.   Germany
  291.  
  292.  
  293. Credits
  294. -------
  295. Thanks to
  296.  
  297. - Rik Swusten/Plextor for lending us a Plextor PX-R24CS
  298.   once and now even permanently a PX-R412C and providing
  299.   the information about the flash ROM commands. Support
  300.   for these drives in MakeCD would have been difficult
  301.   without this support, and FlashROM would have been
  302.   impossible without the information.
  303. - Craig Campbell/Yamaha for providing three drives and the
  304.   required documentation. This is indeed a very generous
  305.   and more than welcome help.
  306. - Thanks to these guys for testing:
  307.   Heinz Wrobel - A4000T internal SCSI + PX-R412C
  308.   Massimo Mancini - A4000T internal SCSI + PX-R820T
  309.   Giulio Guaglianone - Amiga IDE (IDEfix?) + CDR4001
  310.   Peter Kulisic - DKB Spitfire Zorro II SCSI2 + CDR400
  311.   Ben Matthew - Phase V 1230scsi.device 8.5 + CDR400
  312.   Tore Bjoernsen - Plextor PX-40S
  313.   Adam Carrano - A4000, CyberStormPPC SCSI controller
  314.                  (cybppc.device V44.57) + PX-R412C
  315.   Adam Carrano's company is also selling MakeCD and the
  316.   Plextor PX-R412C, so here's the full address ;-)
  317.   APS
  318.   15 rue Louis Maurel
  319.   13006 Marseille
  320.   France
  321.   phone: 04.91.00.30.44
  322.     fax: 04.91.00.30.43
  323.    http://www.aps.fr/
  324.  
  325.  
  326. Known drives
  327. ------------
  328.  
  329. PLEXTOR CD-R   PX-R412C  (flash mode not enabled)
  330. PLEXTOR *Program Mode1*  (a PX-R412C with flash mode enabled)
  331.  
  332.    The firmware is checked in advance. No command line options
  333.    are required to update this drive.
  334.  
  335.    If the firmware download goes wrong, you will be told so by
  336.    FlashROM and/or the Plextor PX-R412C will light two LEDs:
  337.    the outer most left (green) and the outer most right (orange).
  338.    But it is still is possible to re-program the drive.
  339.  
  340.  
  341. PLEXTOR CD-R   PX-R820T
  342. PLEXTOR CD-R   PX-W4220T
  343. PLEXTOR CD-R   PX-W8220T
  344. PLEXTOR CD-ROM PX-40TS
  345. PLEXTOR CD-ROM PX-40TW
  346.  
  347.    FlashROM will only check for byte errors in the firmware file,
  348.    but the firmware will also be checked by the drive itself and
  349.    FlashROM will be told if it was suitable or not. No command
  350.    line options are required to update these drives.
  351.  
  352.    Error codes:
  353.    $9/$87/$0 - FIRMWARE DATA ERROR
  354.                Your firmware file is damaged or not uncompressed.
  355.                It might also get damaged unnoticedly during transfer.
  356.    $9/$88/$0 - TRANSFER DATA ERROR
  357.                The drive has detected a transfer error of the
  358.                firmware data.
  359.    If the firmware download goes wrong, orange and green LEDs
  360.    will blink alternately and the tray load/eject will not work.
  361.    But it is still is possible to re-program the drive.
  362.  
  363.  
  364. YAMAHA CDR400c
  365. YAMAHA CDR400t
  366. YAMAHA CDR401t
  367. YAMAHA CDR200c
  368. YAMAHA CDR200t
  369. YAMAHA CRW2260
  370. YAMAHA CRW2260t
  371. YAMAHA CRW4260
  372. YAMAHA CRW4260t
  373. YAMAHA CRW4261
  374. YAMAHA CRW4001
  375. YAMAHA CRW2216S
  376. YAMAHA CRW2216E
  377. YAMAHA CRW4416S
  378. YAMAHA CRW4416E
  379. YAMAHA CRW6416S
  380. YAMAHA CRW6416E
  381.  
  382.    The exact type of the drive (caddy "c", tray "t", SCSI "S",
  383.    IDE "E") is irrelevant for flashing the ROM.
  384.  
  385.    The firmware cannot be checked in advance and these drives
  386.    will take over invalid data. This would lead to the situation
  387.    described in the next paragraph:
  388.  
  389.    If the drives flash ROM became invalid somehow, it will show
  390.    up on the SCSI bus with "CORE" attached to the product code.
  391.    If DISC and Read/Write light are solid amber, it can still be
  392.    re-programmes. A drive in this state should still be recognized
  393.    by FlashROM. Otherwise use the DRIVE command line argument to
  394.    specify the drive.
  395.  
  396.    DISC and Read/Write light blinking red indicate that the Servo
  397.    information has been over written. According to Yamaha this
  398.    should be impossible, but it has happend under yet unknown
  399.    circumstances. A reflash will not resolve the issue.
  400.  
  401.    New Yamaha models are supported by overriding the drive ID
  402.    and specifying the ROM offset in hex. This offset can be
  403.    inquired from the Yamaha support. Here is how the CDR4416S
  404.    could be flashed if it was not known already:
  405.    
  406. | 15.Ram Disk:> FlashROM dracoscsi.device 2 CDRW4416S_10e.bin DRIVE "YAMAHA CDR400c" OPTIONS 10800
  407. | Checking unit 2 at dracoscsi.device:
  408. |   2. YAMAHA CRW4416S 1.0e = YAMAHA CDR400c - supported
  409.  
  410.    Make sure you got the correct offset and specify it in hex
  411.    _without_ a prefix like $ or 0x.
  412.  
  413.  
  414. History
  415. -------
  416.  
  417. V1.0 - initial release for Plextor PX-R412C
  418. V1.1 - added support for Yamaha drives and Plextor PX-R820T
  419. V1.2 - added recognition of Yamaha CRW6416S/E and support for
  420.        Plextor CD-ROM 40TS/W,
  421.        added simple file check for Plextor firmware files
  422.  
  423.  
  424. Support for other drives
  425. ------------------------
  426.  
  427. Here are my preconditions for adding support of other drives:
  428.  
  429. 1. The vendor supports the implementation by providing the
  430.    documentation of the required commands.
  431. 2. I won't be held liable for any damage.
  432. 3. I get at least one free example of the hardware.
  433. 4. The hardware should be fairly well spreaded.
  434.  
  435. Item 1 and 2 are absolutely necessary - especially analyzing other
  436. software to learn about the required commands is out of question. The
  437. other items however are negotiable: if someone is willing to pay me,
  438. such offers are welcome. I have to live on something in the end, and
  439. eating hardware isn't very healthy ;-)
  440.